# Claude Code 使用

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

本文档介绍在 Quectel Pi M1 上安装、配置并使用 Claude Code 的基本方法。Claude Code 可在终端中协助完成代码编写、文件修改、命令执行和项目分析等工作，适合用于板端应用开发、脚本调试和示例工程验证。

Claude Code 官方文档请参考：[Claude Code Docs](<https://code.claude.com/docs/zh-CN/overview>)。

## 准备工作

在开始安装前，请确认满足以下条件：

- 设备使用的是Debian系统固件

- 设备已连接网络；

- 当前用户具有 `sudo` 权限；

- 已获取 Claude Code 服务地址、访问令牌和模型名称等配置参数。

本文示例中的 ``<your_api_token>``、``<your_base_url>`` 和 ``<model_name>`` 请替换为实际获取到的参数。

## 安装步骤

### 安装基础工具

更新系统软件源，并安装 `curl`、`git` 等基础工具：

```bash
sudo apt update
sudo apt install -y curl git ca-certificates build-essential jq
```

### 安装 Node.js 22

Claude Code 通过 npm 安装，建议使用 Node.js 22 或更新版本。可通过 NodeSource 安装 Node.js 22：

```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
```

安装完成后，验证 Node.js 和 npm 版本：

```bash
node -v
npm -v
```

若终端能够正常输出版本号，则表示 Node.js 环境已安装完成。

### 安装 Claude Code

使用 npm 全局安装 Claude Code：

```bash
sudo npm install -g @anthropic-ai/claude-code
```

安装完成后，验证 Claude Code 是否可用：

```bash
claude --version
```

若终端能够正常输出版本号，则表示安装成功。

## 配置访问参数

### 使用官方服务

如果直接使用官方 Claude Code 服务，在当前终端中设置访问令牌：

```bash
export ANTHROPIC_AUTH_TOKEN=<your_api_token>
```

### 使用代理或企业网关

如果通过代理服务或企业网关访问，同时配置服务地址、访问令牌和模型参数：

```bash
export ANTHROPIC_BASE_URL=<your_base_url>export ANTHROPIC_AUTH_TOKEN=<your_api_token>export API_TIMEOUT_MS=600000export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1export ANTHROPIC_MODEL=<model_name>export ANTHROPIC_SMALL_FAST_MODEL=<small_fast_model_name>
```

参数说明如下：

| **参数** | **说明** |
| --- | --- |
| ANTHROPIC_BASE_URL | API 服务地址。使用官方服务时通常无需设置。 |
| ANTHROPIC_AUTH_TOKEN | Claude Code 访问令牌。 |
| API_TIMEOUT_MS | API 请求等待时间，网络较慢或模型响应较慢时可适当调大。 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 设置为 1 后关闭非必要流量。 |
| ANTHROPIC_MODEL | 默认使用的主模型。 |
| ANTHROPIC_SMALL_FAST_MODEL | 默认使用的轻量快速模型。 |

上述 `export` 命令只对当前终端会话生效。若需要长期生效，可将环境变量写入 `~/.bashrc` 或其他 shell 配置文件中。

## 启动 Claude Code

完成安装和环境变量配置后，在终端中执行以下命令启动 Claude Code：

```bash
claude
```

首次启动时，Claude Code 可能会进行登录校验、配置确认或权限提示。请根据终端提示完成初始化。

## 使用示例

### 分析项目代码结构

进入需要分析的项目目录，启动 Claude Code 后输入分析指令：

```bash
cd ~/my_project
claude
```

在 Claude Code 交互界面中输入任务描述，例如：

```plaintext
分析当前项目的代码结构，列出主要模块、入口文件和依赖关系。
```

Claude Code 会自动读取项目中的文件和目录，输出代码结构概览、模块划分及调用关系等信息，帮助快速了解陌生项目的整体架构。

```{image} images/image_Y2RwbiKGboZfyqxh0IGcp6rlnRf.webp
:width: 1920px
:height: 1080px
:align: center
```

```{image} images/image_GPa7be8zyoDfevxhu2rcS52wnXc.webp
:width: 1920px
:height: 1080px
:align: center
```

## 常用命令

查看 Claude Code 版本：

```bash
claude --version
```

查看 Claude Code 帮助信息：

```bash
claude --help
```

进入项目目录并启动 Claude Code：

```bash
cd <project_path>
claude
```

管理对话：

| **命令** | **功能** |
| --- | --- |
| claude --continue | 恢复当前目录中最近的会话 |
| claude --resume | 打开会话管理器 |
| claude --resume | 直接恢复命名的会话 |
| claude --from-pr | 恢复链接到该拉取请求的会话 |
| /resume | 从活跃会话内切换到不同的对话 |

## 问题处理

- 若执行 `claude` 后提示命令不存在，请重新确认 npm 全局安装是否成功，并检查 npm 全局命令目录是否已加入 `PATH`；

- 若 `npm install` 下载较慢，可根据实际网络环境配置 npm 镜像源后重新安装；

- 若启动后提示认证失败，请检查 `ANTHROPIC_AUTH_TOKEN` 是否配置正确；

- 若使用代理或企业网关后无法连接，请检查 `ANTHROPIC_BASE_URL`、模型名称和网络连通性；

- 若执行硬件控制任务，请先确认引脚复用关系、GPIO 访问权限和外设连接方式。